home *** CD-ROM | disk | FTP | other *** search
/ Programming Sound Cards / Programming Sound Cards.iso / sound_68 / sbc-lib.doc < prev    next >
Text File  |  1995-01-01  |  4KB  |  103 lines
  1.      Function documentation of Creative Sound Library Module
  2.  
  3. 1. Introduction
  4.  
  5.     Author          :  T S Lee
  6.     Version         :  1.00
  7.     Last Updated    :  29 Sep 1989
  8.  
  9.  
  10.     This version uses a more reliable detection scheme, and the
  11.     codes are further optimized.
  12.  
  13.     Please replace all older versions with it.
  14.  
  15.     The  library  functions provided is for Microsoft  C  version
  16.     5.00 and above. All the memory models, SMALL, COMPACT, MEDIUM
  17.     and  LARGE  are  available. These functions  are  grouped  in
  18.     library files named in following conversion:
  19.  
  20.           SBCx.LIB
  21.  
  22.     where  "x"  is the first character of the  respective  memory
  23.     model.
  24.  
  25.     The default segment and group name defined in Microsoft C for
  26.     each memory model is used to ensure compatibility. Any global
  27.     variable  memtioned in following section must be declared  in
  28.     the default data segment '_DATA'.
  29.  
  30.  
  31.     The  FM feature of the Sound Blaster Card (SBC)  an  optional
  32.     item in some OEM versions. So we suggest that if you want  to
  33.     play  FM  music on the Sound Blaster Card, separate  FM  chip
  34.     detection is required.
  35.  
  36.  
  37. 2. Function Documentation
  38.  
  39. Function    :  unint _ct_card_here()
  40. Description :  Check   for  the  availibities  of   the   various
  41.                music/sound  features  provided by  Creative.
  42.  
  43.                The  check is based on the I/O address  stored  in
  44.                the global variable ct_io_addx which is defined in
  45.                the application program.
  46.  
  47. Entry       :  none
  48. Return      :  Music/Sound feature available
  49.  
  50.                High byte is alway zero now
  51.                Low byte right most 3 bits indicate as follow
  52.  
  53.                     bit 0 : on for C/MS music available
  54.                     bit 1 : on for FM music available
  55.                     bit 2 : on for Creative voice available
  56.  
  57.                The type of Creative Music/Sound Card available on
  58.                the  system  can  be determined  with  the  return
  59.                value.
  60.  
  61.                Game  Blaster Card returns 1. Sound  Blaster  Card
  62.                without  optional FM music returns 5, with the  FM
  63.                music it returns 7.
  64.  
  65.  
  66. Note        -  The I/O address used for the music/sound card must
  67.                be   stored   in  ct_io_addx  before   the   call.
  68.                (Application can set this variable to the  factory
  69.                defualt value, 220 Hex).
  70.  
  71.             -  A  zero return value may due to wrong I/O  address
  72.                used.
  73.  
  74.  
  75.  
  76. Function    :  unint sbc_version()
  77. Description :  Return the version number of the DSP on the SBC.
  78. Entry       :  none
  79. Exit        :  version number, high byte major version 
  80.                                low byte minor version
  81.  
  82.  
  83.  
  84.  
  85. Function    :  void sbc_scan_int
  86. Description :  Scan  for  the interrupt number selected  for  the 
  87.                voice   card  and  update  the   global   variable 
  88.                ct_int_num.
  89. Entry       :  ct_io_addx must be set with the correct I/O.
  90. Exit        :  The  global variable, ct_int_num, is updated  with
  91.                one  of the following 2, 3, 5 or 7. If it is  zero 
  92.                on return, the card DMA fails.
  93.  
  94.  
  95.  
  96. Function    :  void sbc_dac_spk(unint on_off_flag)
  97. Description :  Turn   on/off  the  DAC  speaker  based   on   the 
  98.                on_off_flag
  99. Entry       :  If  the on_off_flag is non-zero, the DAC speak  is 
  100.                turned on. A zero will turn it off.
  101. Exit        :  none
  102.  
  103.